home *** CD-ROM | disk | FTP | other *** search
/ Aminet 8 / Aminet 8 (1995)(GTI - Schatztruhe)[!][Oct 1995].iso / Aminet / dev / asm / PhxAss420.readme < prev    next >
Text File  |  1995-09-20  |  11KB  |  213 lines
  1. Short:    PhxAss V4.20 68xxx Macro Assembler
  2. Author:   frank@phoenix.owl.de (Frank Wille, Phoenix/Phantasm)
  3. Uploader: fwille@techfak.uni-bielefeld.de
  4. Type:     dev/asm
  5.  
  6. This archive contains the Assembler PhxAss V4.20 and the Linker
  7. PhxLnk V4.17.
  8.  
  9. *** PHXASS ***
  10. PhxAss V4.20 is a highly optimizing macro assembler for Motorola's 680x0
  11. CPUs, 6888x FPUs and 68851 MMU (of course, the 030, 040 and 060 MMUs are
  12. also supported). It requires OS2.04 (V37) and 1 MB RAM as minimum.
  13.  
  14. Most important features:
  15. o Fast: 15000-30000 lines per minute with standard Amigas, 50000-350000
  16.   with A4000/040.
  17. o Resident.
  18. o Symbolic and Source Level Debugging.
  19. o Automatic generation of executables (if possible).
  20. o Creates relocatable Amiga-DOS objects or absolute code (written into
  21.   a file (raw or Motorola S-Format), into memory or directly onto disk).
  22. o Small Code and Small Data support (also support for __MERGED sections).
  23. o Listing file, Cross Reference Listing, Equates file.
  24. o Complete floating point support: You may use complex floating point
  25.   expressions, including float functions (sine, logarithm, square root,
  26.   power, etc.), everywhere in your source, e.g. defining float EQUates or
  27.   SETs.
  28. o Switches for nine different optimizations.
  29. o Locale symbols (xxx$ and .xxx type).
  30. o Up to 36 macro parameters.
  31. o Support for Motorola's old and new operand style (even in 68000 mode).
  32. o locale.library usage (english, german, swedish, italian, danish and
  33.   french ).
  34. o Nearly all directives of the most popular assemblers like Seka, DevPac or
  35.   AS (Aztec) are supported. Example: INCBIN, INCDIR, CODE_C, REPT, RS,
  36.   RSRESET, EQUR, REG, OFFSET, XDEF, XREF, PUBLIC, ...
  37. o Further development and support is guaranteed for years, because I'll
  38.   *never* change my system (Amiga forever!).
  39. o Finally: Although Shareware, there are no disabled functions in PhxAss!
  40.  
  41. You will find four different versions of PhxAss in this distribution:
  42. 1. PhxAss: The standard 680x0,FPU,MMU macro assembler.
  43. 2. SmallPhxAss: This is a 68000-only version without floating point support.
  44. 3. FreePhxAss: This program is FREEWARE! It is intended for developers of
  45.     PD-Compilers, who want to include PhxAss in their compiler package.
  46. 4. GigaPhxAss: Identical to PhxAss, but source codes are not limited to
  47.     65535 lines. Quite useful for assembling huge Reassembler outputs.
  48.  
  49. CHANGES SINCE PHXASS V4.18 (last Aminet release):
  50. Fixed Bugs:
  51. o Long range branches, which were explicitely defined as Byte branches,
  52.   were made to Word instead Long. This caused an error in the following
  53.   branch optimizations.
  54. o Distance shifts didn't work with equates (EQU).
  55. o Distance shifts didn't get the correct value in the listing file.
  56. o Forgot to close two math-libraries during clean-up.
  57. o Usage of scaling in 68000 mode will generate an error message now.
  58. o ASL will be optimized to ADD by (n)ormal optimization (if possible).
  59. o \@ generates '_000' labels instead '000'. So you will be no longer
  60.   forced to change you exec/types.i include file.
  61. o It is possible again, to create an object file which contains only
  62.   absolute XDEFs. It was already possible before v4.00, I think. ;)
  63. o Now you will get an error message, when a symbol inside a macro was
  64.   defined twice.
  65. o When both Data and Bss sections were empty in small data mode, PhxAss
  66.   generated an object file with 65535 size fields in the hunk header.
  67.  
  68. New Features:
  69. o Relocatable symbols will be suffixed by a ' in the listing file.
  70. o SECTION allows a numerical third parameter to select the type of the
  71.   section (should be $40000000 or $80000000, of course!).
  72. o Freeware-PhxAss assembles 68030-060, FPU and MMU code too.
  73. o Dutch catalog.
  74. o EQUR works with register symbols.
  75. o New directive FREG. It's like REG, but for the FPU registers. So FMOVEMs
  76.   without any registers, which could be generated by a compiler, can be
  77.   removed by optimization.
  78. o Support for PHXOPTIONS option files, which are created by PhxOpts from
  79.   Johan Johanssen. PhxOpts offers a GUI for presetting the options of
  80.   PhxAss. But of course, the command line options have still priority.
  81. o PHXASSINC has moved to ENV:PhxAss/ like the global PHXOPTIONS.
  82. o New directives SAVE and RESTORE to save name and type of the current
  83.   section. Useful in macros.
  84.  
  85.  
  86. *** PHXLNK ***
  87. PhxLnk is FREEWARE and supports all features of a standard Amiga-DOS linker
  88. (like BLink), except of overlay hunks and automatic link vectors (ALV).
  89.  
  90. Implemented functions:
  91. o Links object files and libraries (SAS/C extended libraries too)
  92. o Sections can be forced to Chip-memory
  93. o Small Code, Small Data
  94. o SAS/C-Blink Small Data compatibility available
  95. o '_MERGED' sections are recognized automatically (and coalesced like
  96.   Small Data sections)
  97. o Symbolic and Source Level Debugging (PowerVisor compatibility included)
  98. o Debug blocks are removed on request
  99. o Deletes empty sections
  100. o Zero bytes at the end of a section will be deleted and appear in the
  101.   HUNK_HEADER block only
  102. o User may define absolute external symbols
  103. o Generates HUNK_RELOC32SHORT blocks by default
  104.  
  105. CHANGES SINCE PHXLNK V4.17 (last Aminet release):
  106. o Dutch catalog.
  107.  
  108.  
  109. ============================= Archive contents =============================
  110.  
  111. Original  Packed Ratio    Date     Time    Name
  112. -------- ------- ----- --------- --------  -------------
  113.      690     290 57.9% 21-Aug-95 15:37:20  file_id.diz
  114.     2657     644 75.7% 28-Dec-94 19:02:04  PhxAss.info
  115.     2657     644 75.7% 28-Dec-94 19:02:04 +Bin.info
  116.    47144   30121 36.1% 21-Aug-95 15:14:38 +FreePhxAss
  117.    58208   37127 36.2% 21-Aug-95 15:19:18 +GigaPhxAss
  118.    58184   37095 36.2% 21-Aug-95 15:20:54 +PhxAss
  119.    19780    9816 50.3% 21-Aug-95 16:38:08 +PhxOpts
  120.      444     256 42.3% 21-Aug-95 19:43:04 +ReadMe
  121.      543     270 50.2% 28-Dec-94 18:47:16 +ReadMe.info
  122.    42064   27769 33.9% 21-Aug-95 15:17:34 +SmallPhxAss
  123.     2657     647 75.6% 28-Dec-94 19:02:04 +Examples.info
  124.    10712    4060 62.0% 21-Aug-95 13:43:14 +DemoSupp.asm
  125.      703     343 51.2% 28-Dec-94 18:27:58 +aga.i
  126.      444     221 50.2% 28-Dec-94 18:27:56 +audio.i
  127.      406     212 47.7% 28-Dec-94 18:27:56 +bitplanes.i
  128.      402     213 47.0% 28-Dec-94 18:27:56 +blitter.i
  129.      331     203 38.6% 28-Dec-94 18:27:58 +cia.i
  130.      640     254 60.3% 28-Dec-94 18:27:56 +color.i
  131.      288     182 36.8% 28-Dec-94 18:27:56 +control.i
  132.      281     182 35.2% 28-Dec-94 18:27:56 +copper.i
  133.     3054     947 68.9% 28-Dec-94 18:27:58 +custom.i
  134.      479     206 56.9% 28-Dec-94 18:27:56 +custom_all.i
  135.      781     370 52.6% 28-Dec-94 18:27:56 +disk.i
  136.      274     187 31.7% 28-Dec-94 18:27:56 +display.i
  137.      719     339 52.8% 28-Dec-94 18:27:58 +dmabits.i
  138.      818     333 59.2% 28-Dec-94 18:27:56 +intbits.i
  139.      283     182 35.6% 28-Dec-94 18:27:56 +ports.i
  140.      766     302 60.5% 28-Dec-94 18:27:56 +sprites.i
  141.       93      69 25.8% 28-Dec-94 18:27:58 +diskfont.i
  142.     2785    1209 56.5% 28-Dec-94 18:27:58 +dos.i
  143.     2326    1002 56.9% 28-Dec-94 18:27:58 +exec.i
  144.      527     262 50.2% 28-Dec-94 18:27:58 +expansion.i
  145.     3244    1332 58.9% 28-Dec-94 18:27:58 +graphics.i
  146.      464     221 52.3% 21-Mar-95 12:19:24 +icon.i
  147.     2750    1129 58.9% 28-Dec-94 18:27:58 +intuition.i
  148.      562     237 57.8% 28-Dec-94 18:27:58 +layers.i
  149.      504     282 44.0% 28-Dec-94 18:27:58 +locale.i
  150.      141      88 37.5% 28-Dec-94 18:27:58 +mathffp.i
  151.      220     110 50.0% 28-Dec-94 18:27:58 +mathieeedoubbas.i
  152.      295     136 53.8% 28-Dec-94 18:28:00 +mathieeedoubtrans.i
  153.      260     130 50.0% 28-Dec-94 18:27:58 +mathtrans.i
  154.       60      53 11.6% 28-Dec-94 18:27:58 +potgo.i
  155.       49      43 12.2% 28-Dec-94 18:27:58 +timer.i
  156.       19      19  0.0% 28-Dec-94 18:27:58 +translator.i
  157.      457     270 40.9% 28-Dec-94 18:27:58 +utility.i
  158.      276     189 31.5% 28-Dec-94 18:41:20 +ReadMe
  159.      543     269 50.4% 28-Dec-94 18:40:48 +ReadMe.info
  160.      256     143 44.1% 28-Dec-94 18:27:56 +VBallImage.ilvd
  161.      380     344  9.4% 25-Feb-95 23:07:56 +vbr
  162.     2786    1303 53.2% 28-Jul-95 14:32:14 +vbr.asm
  163.     2716    2063 24.0% 25-Feb-95 23:09:06 +VectorBalls
  164.     9573    3972 58.5% 25-Feb-95 23:08:42 +VectorBalls.asm
  165.     2657     648 75.6% 28-Dec-94 19:02:04 +Locale.info
  166.     5408    2636 51.2% 11-Aug-95 17:23:34 +PhxAss.catalog
  167.     6190    2873 53.5% 11-Aug-95 17:23:10 +PhxAss.catalog
  168.     6032    2764 54.1% 11-Aug-95 17:23:44 +PhxAss.catalog
  169.     5886    2758 53.1% 11-Aug-95 17:24:04 +PhxAss.catalog
  170.     5762    2676 53.5% 11-Aug-95 17:24:18 +PhxAss.catalog
  171.     5290    2659 49.7% 11-Aug-95 17:24:30 +PhxAss.catalog
  172.     5568    2455 55.9% 11-Aug-95 17:25:02 +PhxAss.cd
  173.     5515    2403 56.4% 11-Aug-95 17:25:00 +PhxAss.ct
  174.     6019    2733 54.5% 11-Aug-95 17:24:54 +PhxAss_d.ct
  175.     5305    2515 52.5% 11-Aug-95 17:24:56 +PhxAss_dk.ct
  176.     5914    2641 55.3% 11-Aug-95 17:24:56 +PhxAss_f.ct
  177.     5725    2615 54.3% 11-Aug-95 17:24:56 +PhxAss_i.ct
  178.     5605    2555 54.4% 11-Aug-95 17:24:56 +PhxAss_nl.ct
  179.    10316    4396 57.3% 11-Aug-95 17:24:56 +PhxAss_pl.ct
  180.     5248    2557 51.2% 11-Aug-95 17:24:56 +PhxAss_s.ct
  181.      235     164 30.2% 28-Dec-94 18:22:16 +ReadMe
  182.      543     268 50.6% 28-Dec-94 18:42:16 +ReadMe.info
  183.   112259   38946 65.3% 21-Aug-95 16:09:28 +PhxAss.guide
  184.     5163     778 84.9% 28-Dec-94 19:02:04 +PhxAss.guide.info
  185.   124852   44886 64.0% 21-Aug-95 16:09:28 +PhxAss_d.guide
  186.     5163     777 84.9% 28-Dec-94 19:02:04 +PhxAss_d.guide.info
  187.     2657     642 75.8% 28-Dec-94 19:00:54  PhxLnk.info
  188.     2657     648 75.6% 28-Dec-94 19:02:58 +Locale.info
  189.     2400    1221 49.1% 06-Jun-95 19:54:40 +PhxLnk.catalog
  190.     2634    1298 50.7% 06-Jun-95 19:54:14 +PhxLnk.catalog
  191.     2658    1305 50.9% 06-Jun-95 19:54:44 +PhxLnk.catalog
  192.     2512    1244 50.4% 06-Jun-95 19:54:32 +PhxLnk.catalog
  193.     2486    1228 50.6% 09-Aug-95 12:36:46 +PhxLnk.catalog
  194.     2370    1208 49.0% 06-Jun-95 19:54:28 +PhxLnk.catalog
  195.     2313    1099 52.4% 19-Mar-95 20:41:32 +PhxLnk.cd
  196.     2391    1118 53.2% 06-Jun-95 19:53:12 +PhxLnk.ct
  197.     2609    1240 52.4% 06-Jun-95 19:53:12 +PhxLnk_d.ct
  198.     2369    1160 51.0% 06-Jun-95 19:53:12 +PhxLnk_dk.ct
  199.     2698    1261 53.2% 06-Jun-95 19:53:12 +PhxLnk_f.ct
  200.     2482    1188 52.1% 06-Jun-95 19:53:12 +PhxLnk_i.ct
  201.     4578    1795 60.7% 09-Aug-95 12:34:14 +PhxLnk_nl.ct
  202.     2416    1193 50.6% 06-Jun-95 19:53:12 +PhxLnk_s.ct
  203.      235     164 30.2% 28-Dec-94 19:02:38 +ReadMe
  204.      543     268 50.6% 28-Dec-94 19:02:38 +ReadMe.info
  205.     9856    6453 34.5% 06-Jun-95 21:50:34 +PhxLnk
  206.    15514    5542 64.2% 06-Jun-95 21:51:46 +PhxLnk.guide
  207.     5163     779 84.9% 28-Dec-94 19:00:54 +PhxLnk.guide.info
  208.    17767    6436 63.7% 06-Jun-95 21:51:46 +PhxLnk_d.guide
  209.     5163     775 84.9% 28-Dec-94 19:00:54 +PhxLnk_d.guide.info
  210.     5107    2544 50.1% 21-Aug-95 15:39:52  README
  211. -------- ------- ----- --------- --------
  212.   729928  337802 53.7% 24-Aug-95 23:56:36   98 files
  213.